.TH std::filesystem::path::assign 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::filesystem::path::assign \- std::filesystem::path::assign

.SH Synopsis
   path& assign( string_type&& source );        \fB(1)\fP \fI(since C++17)\fP
   template< class Source >                     \fB(2)\fP \fI(since C++17)\fP
   path& assign( const Source& source );
   template< class InputIt >                    \fB(3)\fP \fI(since C++17)\fP
   path& assign( InputIt first, InputIt last );

   Replaces the contents to the path object by a new pathname constructed from the
   given character sequence.

   1) Assigns the pathname identified by the detected-format string source, which is
   left in valid, but unspecified state.
   2) Assigns the pathname identified by the detected-format character range source.
   3) Assigns the pathname identified by detected-format character range [first, last).

   \fB(2)\fP participates in overload resolution only if Source and path are not the same
   type, and either:

     * Source is a specialization of std::basic_string or std::basic_string_view, or
     * std::iterator_traits<std::decay_t<Source>>::value_type is valid and denotes a
       possibly const-qualified encoding character type (char,
       char8_t,
       \fI(since C++20)\fPchar16_t, char32_t, or wchar_t).

.SH Parameters

                 a character range to use, represented as std::string,
   source      - std::string_view, pointer to a null-terminated multibyte string, or as
                 an input iterator with char value type that points to a
                 null-terminated multibyte string
   first, last - a character range to use
.SH Type requirements
   -
   InputIt must meet the requirements of LegacyInputIterator.
   -
   The value type of InputIt must be one of the encoded character types (char, wchar_t,
   char16_t and char32_t)

.SH Return value

   *this

   Defect reports

   The following behavior-changing defect reports were applied retroactively to
   previously published C++ standards.

      DR    Applied to              Behavior as published              Correct behavior
   LWG 3244 C++17      constraint that Source cannot be path was       added
                       missing

.SH See also

   operator= assigns another path
             \fI(public member function)\fP
